home *** CD-ROM | disk | FTP | other *** search
/ AOL File Library: 9,300 to 9,399 / 9300.zip / AOLDLs / HTML & Web Tools (MAC) / HTML_ TagStripper 1.0 / TagStripper v1.0 Ä.sit / TagStripper v1.0 ƒ / NetStripper v2.5.2 ƒ / NetStripper 2.5.2 Read Me next >
Text File  |  1996-03-26  |  11KB  |  143 lines
  1. NetStripper v2.5.2 FAT
  2. Copyright ⌐ 1995-96 Adam Lloyd  (Progress Bar CDEF 1.4 ⌐ Eddy J. Gurney and Matt Slot)
  3. Internet email: adam@park78.ftech.co.uk
  4. Note to archive administators: this version of NetStripper replaces v1.1, 1.1.2, 1.1.4, 2.0, 2.5 & v2.5.1.
  5.  
  6. TagStripper Users: if you register TagStripper by paying your US$15, you can ignore the request for a postcard below. If you don't pay for TagStripper (because you aren't going to use it) but do use NetStripper, please send me a postcard.
  7.  
  8. New in this version
  9.  
  10. You can now access the NetStripper Support and Information Site on the WWW at http://www.geocities.com/Tokyo/2061/ns-home.html. The site contains information on the current version of NetStripper, a feedback page, information on registering as a user and information on future directions that the program might take.
  11.  
  12. Legal Information
  13.  
  14. NetStripper is a postcardware application written by Adam Lloyd. This means that you, the user, are entitled to use it and give it to anyone else you want, on condition that you include this read me file with the program. And send me a postcard, of course╔ However, this program must not be sold for profit, and I would be grateful if shareware CD-ROM compilers and/or magazines would let me know if they are going to put it on their disks: I have nothing against that and in fact positively encourage it, but would just like to know where it is going.
  15.  
  16. In addition, I accept no responsibility or liability for this program or any damage that it might cause to your data or your computer. Use with care, and use at your own risk.
  17.  
  18. All trademarks mentioned in this documentation are the property of their various owners and are used for informational purposes only.
  19.  
  20. Postcardware
  21.  
  22. NetStripper is postcardware. What this means for you is that, if you find the program useful, I would appreciate a postcard of your home town from you - or an email message. Don't feel obliged to send a card if you don't want to, but please let me know somehow that you are using the program. People who've already registered an earlier version don't need to send a postcard, of course.
  23.  
  24. Probably the most important thing you can do, though, is let me know what your email address is, as only then can I keep you informed of when new versions are available.
  25.  
  26. My postal address is:
  27.  
  28. Adam Lloyd
  29. Park Lodge
  30. Bishops Down Park Road
  31. Tunbridge Wells
  32. Kent TN4 8XR
  33. UNITED KINGDOM
  34.  
  35. System Requirements
  36.  
  37. NetStripper needs any Macintosh¬ or Power Macintosh¬ to run, with System 7 or higher (including System 7.5). On a PowerMac, NetStripper runs in native mode, but it will also run on older systems. One detail of which you must be aware is that the memory allocated to NetStripper, in the Finder's Get Info box, must be equal to the size of the largest text file you intend to process with an extra 50k added on. So, if your biggest file will be 123k the Minimum allocation in the Get Info box must be 173k. Any higher is okay, but any lower is not acceptable and may well result in a crash - it shouldn't, but it has happened. Of course, don't go below the Minimum value presented in the Get Info╔ box.
  38.  
  39. What is NetStripper?
  40.  
  41. NetStripper is a utility that essentially takes DOS or Unix¿ formatted text files and converts them into Macintosh formatted text files. What this does is remove the DOS-specific characters from the files and leave them in a more easily readable state. Previously the only way to do this was to use a large word processor such as Microsoft Word or a text editor with search-and-replace, but this was cumbersome and so I decided to write a utility to automate the process.
  42.  
  43. NetStripper also contains two other translation modes: one takes a Macintosh text file and converts it back into DOS format, and the other performs a slightly more esoteric function that by popular demand I added back in version 1.1. That function is to take any double carriage return characters in a Mac text file and turn them into a single carriage return, while deleting any single carriage returns that were there before. As I said it's a strange translation, but people seem to need it so I've added it.
  44.  
  45. v2.5.1: In this latest version, the carriage-return mode has two behaviours, either one of which you can select from the Preferences╔ command in the File menu.
  46.  
  47. How do I use NetStripper?
  48.  
  49. Warning: NetStripper replaces the original versions of the files it translates with the modified ones. You might want to keep copies of the original files in case something goes horribly wrong.
  50.  
  51. You use NetStripper simply by placing its icon, or an alias to its icon, in a prominent place on your desktop. Then, when you have a batch of files (or even a single file!) that needs translating just drop them onto its icon or alias and sit back to watch. A dialog box will appear on your screen, telling you the name of the current file, how many have been processed out of the total number dropped onto the icon, and the type of translation being performed.
  52.  
  53. To use the standard DOS to Mac translation all you need to do is drop the text files on to NetStripper. But to use the other translation modes you must hold down a certain key while NetStripper starts up.
  54.  
  55. So, to translate a Mac text file into a DOS text file, drop it onto NetStripper's icon while holding down the Command key (that's the one with the squiggly clover-leaf picture and the Apple symbol on it). Keep it held down until the progress dialog appears! In the Progress dialog NetStripper will say that it is using Mac-To-DOS mode, and that is exactly what will happen to your files.
  56.  
  57. The third function, dealing with the carriage returns, is activated by the Option key (labelled option on the keyboard). Again, drop the files you want to process on to NetStripper's icon, but hold down the option key as you are doing so, keeping it held down until the progress dialog appears. Single carriage returns will be removed from the file and double carriage returns will be changed into single ones.
  58.  
  59. v2.5.1: The carriage return mode, as I said earlier, has two types of operation it can perform now. You can choose which one to use from the Preferences command in the File menu, and here is a quick description of what the options do:
  60.  
  61. Ñ The 'Original (CRCR->CR, CR->nil!)' option does what is described above.
  62. Ñ The 'Strip single CRs but keep double CRs' option removes all single carriage returns from a document but, where there are two or more carriage returns, leaves them intact. This can preserve more of the original formatting of a document.
  63.  
  64. Now, supposing I want to do something else while translating some files? Dropping two hundred 3k files on it means quite a wait, you know. 
  65.  
  66. NetStripper includes the ability to process files in the background. What this means, simply, is that after dropping your two hundred 3k files on to its icon, or whatever your processing happens to be, is that you don't have to sit around looking at the progress bar for half an hour or more. Just click on a window belonging to another program, or use the Application menu at the top right-hand corner of the screen, to switch to any other running program or the Finder. NetStripper runs a bit more slowly in the background, but not so much that you'd notice any appreciable difference.
  67.  
  68. What about  AppleScript support?
  69.  
  70. If you open NetStripper's dictionary using the Script Editor (supplied with System 7.5), you'll see three commands in the NetStripper Suite: Mac to DOS, DOS To Mac and CR Strip. You can use these commands to process a file using your chosen translation mode. See the example script, NetStripper Scripting Example, supplied in the archive for an idea of how to use the scripting abilities.
  71.  
  72. And that's all there is to it?
  73.  
  74. Absolutely. NetStripper is intended to be a simple utility, and provided you follow the instructions above you should have no problems at all. There are no known bugs in v2.5.1, but please do make sure that you follow the memory guidelines laid out in the System Requirements section at the top of this document.
  75.  
  76. Of course, if you do find any bugs then let me know at adam@park78.ftech.co.uk and I'll do my best to fix them.
  77.  
  78. Is there anything else I should know?
  79.  
  80. NetStripper is a FAT binary, in other words contains code for PowerMac systems and older systems so it runs at optimal speeds on both types of Mac.
  81.  
  82. The only thing I ask you to do in connection with NetStripper is that if you use it, please send a message to adam@park78.ftech.co.uk letting me know, including any comments you might have. In return I'll add you to a mailing list so that as a registered user you receive new versions before the rest of the world. You'll also receive sneak previews of future versions, and of any other freeware software projects that I start work on. On the other hand, if you feel that way inclined, send me a postcard from your home town (my address is somewhere near the top of this document). Whatever you do, though, tell me your email address so that I can keep you informed of future versions as soon as they are available.
  83.  
  84. But the main thing is that you find NetStripper useful and enjoy it.
  85.  
  86. Adam.
  87. 20th March 1996.
  88.  
  89. Version History
  90.  
  91. 1.0.0: 5th May 1995
  92. First public release: no doubt packed with unsavoury bugs.
  93.  
  94. 1.0.3: 12th May 1995
  95. The problem involving NetStripper refusing to run on a Mac IIfx has been fixed.
  96. The Apple menu now works.
  97.  
  98. 1.1: 3rd July 1995
  99. Highly unpleasant memory bug fixed.
  100. Two new translation modes added at users' requests.
  101. Interface modified slightly to include translation type in progress dialog.
  102. Some operations speeded up slightly.
  103. Documentation rewritten.
  104.  
  105. 1.1.2: 26th August 1995
  106. Progress bar added to processing dialog.
  107. All translations speeded up minutely.
  108.  
  109. 1.1.4: 26th August 1995
  110. Bug where progress bar didn't function file files bigger than 32k fixed.
  111.  
  112. 2.0: 23rd September 1995
  113. Background capabilities added and a couple of bugs ironed out.
  114. AppleScript fully integrated for public consumption.
  115. Progress dialogue can now be dragged around the screen.
  116.  
  117. 2.5 FAT: 3rd November 1995
  118. Modified and recompiled to be PowerMac native, in a FAT binary. At last!
  119. A few small bugs removed, including incompatibility with Malph.
  120. Better error-checking and reporting.
  121.  
  122. 2.5.1 FAT: 19th February 1996
  123. Preferences added to allow for dual CR-strip mode. No other changes.
  124.  
  125. 2.5.2 FAT: 20th March 1996
  126. Teeny-weeny bug fix, and new address.
  127.  
  128. Thanked People
  129.  
  130. MetroWerks, for the utterly amazing CodeWarrior.
  131. Apple, for the equally amazing Macintosh and PowerMac.
  132. Frontier Internet Services Ltd (info@ftech.net), for providing me with Internet access in the UK.
  133.  
  134. Eddy J. Gurney and Matt Slot for the Progress Bar CDEF 1.4 (their copyright, of course).
  135.  
  136. Jim Carr for discovering that v1.0 didn't work at all on a Mac IIfx and being very patient while I sent him countless versions over a period of three or four days.
  137. Herb Wideman for suggesting the CRCR->CR, CR->nil! feature.
  138. Peter Baum for suggesting the progress bar.
  139. Bob Erickson for enquiring about the possibilities of AppleScript compatibility.
  140.  
  141. Special thanks go to Mike Coan, for helping an awful lot with the testing of earlier versions and v2.0, as well as suggesting numerous enhancements and pointing out little flaws in the program. And for assisting in testing the PowerMac native version, of course, and finding the Malph-related problem. Thanks again Mike.
  142.  
  143. Anyone else I haven't mentioned specifically but who deserves it.